------------------------------------------------------------------------------- GRAFSTAT Graphical Status Control version 1.0 Copyright (c) 1991 by Object Productivity, Inc. =============================================================================== PURPOSE... GrafStat is a custom control that displays a graphical gauge representing the status of a given process. Currently, GrafStat can emulate one general type of gauge, the indicator. The indicator linearly represents an integer magnitude within a given range by displaying, graphically, it's current value. The indicator provides two styles, thermometer and needle. The thermometer style represents process-status' as a partially "filled" value-region within a rectangular area. The needle style similarly represents process-status', except that the value region (including and previous to the value mark) is not filled. All GrafStat styles allow the customization of their appearance and function (e.g. display value or percent text, changing colors, orientation, etc.). In the future, GrafStat will be extended to emulate several additional types of gauges and many different styles. Currently, GrafStat is simple, yet is valuable in uses such as file-transfer, installation, data-acquisition, performance analysis, and compression, to name a few. FUNCTION... The GrafStat control has 3 general areas of functionality, namely, setting the style, setting the range, and setting the current value (position). Currently, the GrafStat control supports the two basic styles mentioned above (i.e. therm., needle), with additional options to effect the orientation of the control and the display of a current value. When the GrafStat control is first created via CreateWindow, or instantiated via a dialog template, it's default appearance is a rectangle with a white background, red foreground, and thermometer style with percent status of 0% out of a range of 100. When using a dialog or form editor, the user can move and resize this control to any rectangular size. Additionally, the user can set the style of the control to an indicator type of thermometer or needle, orientation of vertical or horizontal, aspect of percent or value, progress of fill-right/down, fill-left/up, empty-right/down, or fill-left-up, and toggle the display of the current value to display or no display. After a GrafStat control has been created via a dialog or the CreateWindow function, the developer can manipulate the control via messages as described bellow. Please see the demonstration application GSDEMO.EXE for a "look-and-feel" of the functionality of GrafStat. MESSAGES... The following messages allow the developer to manipulate an instance of a GrafStat control by sending messages via the SendMessage function. Each message is listed with a description of the word-parameter (wParam). The long parameter (lParam) is not used in any of these messages. See your SDK or Windows reference for more information on this or related topics. GSM_SETSTYLE Set the style of the grafstat control, wParam=style. The style can include any combination of styles, one from each line, GSS_THERMOMETER or GSS_NEEDLE GSS_HORIZONTAL or GSS_VERTICAL GSS_PERCENT or GSS_VALUE GSS_TEXT or GSS_NOTEXT GSS_FILL or GSS_EMPTY GSS_RIGHTDOWN or GSS_LEFTUP See the demonstration source-code and executable for examples of these styles and their appearance. GSM_SETRANGE Set the range of the grafstat control, wParam=integer- range (not int type). GSM_SETPOSITION Set the position of the grafstat control, wParam=integer-position (not int type). GSM_DELTAPOSITION Add to the current position, wParam=integer-delta (value to add to current position). GSM_SETFORGCOLOR Set the foreground (indicator) color, wParam=CREF (rgb value, see your SDK). GSM_SETBACKCOLOR Set the background color, wParam=CREF (rgb value). ------------------------------------------------------------------------------- (see order.txt for info. on obtaining the grafstat custom control & source) ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 3,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 Orders only: 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.